Skip to content

为了文件夹的整洁,不希望在每个文件夹下都单独有一个 index.md 文件,而是希望统一在 /docs/blog-info/ 目录下。

查阅 官方文档的API列表,发现提供了 rewrites 选项,完美符合统一单个文件的目的。

ts
export default {
  rewrites: {
    'path/to/A': 'path/to/B'
  }
}

经考察,发现该函数是在生成文档的编译阶段,依据相对 docs 的路径,把 A 文件输出为指定的 B 文件。

我作了如下的文件路径映射

ts
import { defineConfig } from 'vitepress'

export default defineConfig({
  
  // 重定向(相对docsDir,且开头不加/)
  rewrites: {
    'blog-info/home.md': 'index.md',
    'blog-info/essay.md': 'blog-essays/index.md',
    'blog-info/post.md': 'blog-posts/index.md',
  },

需要注意的是,在尝试过程中发现,路径开头不能有 / ,否则不生效。

本站访客数 人次 本站总访问量